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GENERAL 


The purpose of this document is to provide a functional description 
of the RJE/TERMINAL system software package» NOL versions as 
implemented for the Burroughs B1700 system. This manual» together 
with the Bh700» and B2700/3700/4700 RJE/SHOST information manuals» 
witl provide the B1700 RJE user with a working knowledge of the 8JE 
Systeme 


The Mark Vel RJE package makes a 81710 or 81720 appear as a remote 
terminal to either a B6700 or 8B2700/3700/4700 central computer» 
enabling the 81700 user to enter a job at the remote system (for 
execution by the central computer» to monitor and control the 
oregram via the 81700 console printers and to receive all retevant 
print and punch outout back at the remote site. 


The package consists of two programs» RJE/MCS and RJE/NDLDCH. The 
latter programe the NOL network  controltter, performs att 
transmitting and receiving of data to and from the central comouter 
and sends atl messages received from the central computer to 
RJE/MCS. RIJE/SMCS performs alt 1/9 for the 81700 RJE/STERMINAL 
Systems» sending all messages received to the appropriate output 
devices» either consola printers printers punchs or if desired» to 
backup Jisk files. In additions RJE/MCS exerts a partial control 
over RJE/NOLOCHe forcing it to resestablish connection with the 
central computers» causing it to idle waiting tc answer a phone catl 
from the central computars or to terminate. 


RELATED DOCUMENTATION 


35709 RJE System Information Manual - > | 5000300 
32700/3700/4700 RJE System Information Manual 

31709 NIL Information Manual | 1073715 
31799 System Software OQoerational Guide 19687 31 


21799 System Data Communication Information Manual 1089992 
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SYSTEM FLOW 
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FIGURE 2e1 B1700 RJE NOL INTERFACE 


The program RJE/MCS controls the 31700 peripherals. It reads cards» 
accepts messages from the console printers» displays messages on the 
console orinters prints output and punches cards. RJE/NDLOCH» on 
the other hands is responsible for data communications with the 
central computer system. The two programs communicate with each 
other through queues. 
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The transfer of data from the remote system to the central computer 
system and back occurs as follows: 


The remote user prepares a card deck for transmission to the central 
somouter system. The card deck is read by RJE/MCS and queued for 
2JE/NOLOCH. RJE/NDLOCH then begins to transmit the card images to 
the central computer system. This process continues until att cards 
are read and transmitted. The job is now under the control of the 
central computer MCP which processes the request and initiates the 
compite or execute function. The BOJ/ENJS messages and all other 
central computer messages pertaining to this job are sent to 
RJE/NDLOCH which in turn queues then for RJE/MCS. These messages 
are then displayed on the 81700 console printer. Central comouter 
system messages can be keyed at the remote console printer to 
control the job. | | 


dahen the jobd is completed» all associated printer and punch output 
created at the central computer systen is transmitted to the 31700. 
Q2JE/NOLOCH accepts this output from the central computer system and 
: © gueues it for RJE/MCSs it is then printed or punched on the iocat 


arinter or punch respectively. 


The above cycle describes the flow of data between the B1700 and the 
central computer system and is referred to as a job stream. Any 
numoer of job streams may be initiated at the same time from the 
217093 the number of jods is limited onty by any central computer 
system restrictions. | 


Pseudo-reader and orinter and punch backup 81/700 system functions 
may aiso be used in conjunction with RJE. 
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SYSTEM RF EQUIREMENTS 
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Sattowing are the hardware requirements: 
224 MEMORY 
34K MCP II 
O7K RJESMCS - 
22% RJE/NDLDCH 
39 N@ 96 COLUMN CARD READER 
8) 9R 96 COLUMN PUNCH 
120 AR 132 POSITION PRINTER 
CONSOLE PRINTER 
DISK CCARTRIOGEs OTSK PACK OR HEAD@PER-TRACK) 
317099 SINGLE“LINE CONTROL OR MULTI-LINE CONTROL 


B1709 STANDARD SYNCHRONOUS» ASYNCHRONOUS OR TWO 
WIRE DIRECT CONNECT ADAPTER 


LEASED» SWITCHED OR DIRECT CONNECTION WITH 
APPROPRIATE DATA SETS AND CABLES 


when using 96 column equipment only 80 columns are used. 


It is suggested that the timeout period be set to 2.5 seconds at the . 
41700 and three seconds at the central computer system. | 


The 31700 RJE/TERMINAL package requires MARK V.1 tevel MCP IT Cor 
higher) and NOL. It requires the following level of central 
computer system softwar2: | 


22700/3700/74700 MCP V ASR 5-3 or higher 
35700 MCP MARK II.5 or higher — 
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GENERATING THE NETWORK CONTROLLER CRJE/NDLDCH) 
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RJESMCS is supplied as object code and requires no user generation. 
Howeverse RJE/SNDLOCHs which is the network controller for RJE» 


requires the user to write NDL specifications to generate the 


specific network controtter. The following tist of guidelines 15 
intended to help the user to generate the correct NOL network. 
controtter. Please refer to 81709 NOL manuals for extended 


snecifications and definitions. 


1. Program name: 
The network controller is here defined RJE/NDLOCHs but it is not 
necessary for it to be so named. 

2. Oectlaration section: 


The only required entry is the specification for the "NIF™ file 
name: | | | | 


NIF=H"RJE"/"NOLOCHNIF™. 
MAX BUFFERS = 2. 

MAX MESSAGES = 20. 

MAX MESSAGE SIZE = 405. 


ar Raquest section: 


The required request section is contained in the NDL Library. [t 
is named *RJE™. | : 


$LIBRARY RJE 


4. Control section: 


The required controt section is contained in the NDL library. It 
is named “"RJECTL™. : . | - 


$LIBRARY RJECTL 
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>. Terminal section: 


Only one terminat entry in the terminal section is required; any 
other values may be used for the remaining statements possible 
within the terminal section ("TYPE” and the name specified for 
the terminal). 


Note: Unless a user written MCS is supplied» the “TERMINAL 
OTAGNOSTIC REQUEST” statement cannot be utilized. 


Required terminal section statements. 


BUFFERS IZE=410-~ 

ADDRESS =2. 

REQUEST=RJESRECEIVEs RJEZTRANSMIT. 
TRANSMISSION=16_ 


Note: The RJE request section is used both for transmittina 
and receiving. 


Station section: 


Four stations are used with RJE» each of which references the 
one terminal section defined above. It is recommended that the 
retry Limit be set at 25 and that the input and output 
frequencies be set to identical vatues. 


The "MYUSE™ statement must be set as follows: 
MYUSE=INPUT»OUTPUT. 

The addresses for the four stations must have the following 

values? | : | | | 
"00" for Station 
"O01" for Station 


"92" for Station 
"03" for Station 


& WN pe 


If other stations are to be defined in the network controtler it 
is absolutely necessary that these be the first four stations 


| 


ape. Pit Satan 9 ed ee, Sissi e Dee th ek ee ee 


Br 


3URROUGHS CORPORATION 


4m 5 


COMPANY CONFIDENTIAL 
COMPUTER SYSTEMS GROUP B1700 RJE/TERMINAL CNDL? 
SANTA BARBARA PLANT | P. Se 2212 5249 


declared in the NOL program. 


7~« Line section: 


The address of the adapter of the tine to be used is specified 
in the tine section. This address will vary from system to 
system. The station statement must reference the four stations 
defined above. | 


The following is a list of required statements in the Line 
section: 


port#» 
channel #>» 
adapter #) 


ADDRESS=P:CsA. (Where 


Ho ou 


P 
C 
| A 
STATION=Station tist. 
CONTROL=RJECTL. 


Qne remote file is required. It is necessary that the following — 
file section be used: | 


FILE MCSQUEUE: 
FAMILY=S1l9S2955954- 


?7e Sample NDL RJE declaration? 
The following is a sample NDL RJE declaration: 


2CG RJE/NDLOCH NOL LI 

2DATA CARDS 

DECLARATION: 
NIF="RJE"/"NDLOCHNIF®. 
MAX BUFFERS = 26 | 
MAX MESSAGES = 20.4 

: MAX MESSAGE SIZE = 405. 

SLIBRARY RJE 

BLIBRARY RJECTL 

TERMINAL 81700: 

«TYPE =63.— 

ADDRESS=¢. 
RBUFFERSIZE=820. 


cL) DeRosa Si ere eee, Stk. 
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TRANSMISSION=1. 
REQUEST=RJESRECE IVE? 


STATION OEFAULT OF: 
TERMINAL=81700. 
RETRY=25. 


FREQUENCY=255» 2556. 


MYUSE=INPUT» OUTPUT. 


STATION S12 
DEFAULT=0F. 
ADDRESS="00". 


STATION $2 
DEFAULT=0F. 
ADDRESS="01"%. 


STATION S33 
NEFAULT=DF. 
ADORESS="02". 


STATION S4&3 
DEFAULT=DF. 
ADDRESS="03". 


LINE CONVERSATIONAL: 
ADDRESS=7:212:20. 
CONTROL=RJEC TL. 
STATION=Sls S2e S3>» 


FILE MCSQUEUE: 
FAMILY=S1>S29S 3 She 


4-4 


COMPANY CONFIDENTIAL 
B1i700 RJE/TERMINAL CNDL) 
P. Se 2212 5249 


RJE TRANSMIT. 
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QUEUE DEPTH CONTROL 


In a computer"-to-computer operation such as RJE there are two 
significant data rates that affect performance and throughput: 


A) DOata Comm line speed 
83) Pertpheral speed 


If the Data Comm tine soeed is relatively stows when compared to the 


operioheral speeds» the peripherals can usually process data faster 
than the Data Comm line can transfer it. 


Lf» in the case of input from the RJE terminal to the central 
comouters» the card reader can process data faster then the OD)ata 
lSomm tine can transmit the data to the central computers the queue 
betwean RJE/MCS and the network controller C"*MCSQUEUE") will grow 
Laraer and targer as the network controller waits for Data Comm 
transmissions to complete. 


To control the size that the input portion of "MCSQUEUE™ can grow 
to» ja marker record system has been imptemented. When RJE/MCS 15 
inserting records into *MCSQUEUE"» RJE/MCS includes a marker = at 
selected intervats. The marker is a special value itn the header of 
the record. The record that contains the marker will also contain 
data read by RJE/MCS. 


After inserting a marker record into the queues RJE/MCS wilt suspend 
all card reading until the network controller acknowledges receipt 
of the marker record from RJE/MCS. The network controtter 
acknowledges the marker record by returning the record with the 
Marker in it to RJE/MCS. 


When RJE/MCS receives” the acknowledgement from the network 
controllers» RJE/MCS starts reading cards again until the next 
marker record 15 sent. 7 


The number of records atlowed to be queued between RJE/MCS and the 
network controller is limited by default to four. However the user 
can change the maximum number by the %.9S" command (See Section 63 
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LOCAL CONTROL MESSAGES). 
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OPERATING PROCEDURE 


a a OE On 8 a a 08 4 8 eee ee 


ESTABLISHMENT 


The RJE oackage 1s initiated by executing RJE/MCS and executing the 
network controtler. If switch 0 has been set ("EX RJE/MCS SW O0=1")> 
then RJE/MCS will display the message: 

"FNTER ID FIELD PLEASE» FROM O TO 17 CHARACTERS.® 


This identification field must be obtained from the personnel at the 
central computer sitee RJE/MCS then disolays the message: 


sete 31700 RJE CDATE) (TIME) «eee 
RJE/NOLDCH will establish communication with the central comnputer. 
system. For switched ltiness it is necessary to manuaily diat the 
central computer system. A message is displayed to indicate central 
comouter connections either 


*"ONLINE.* or *HOST ESTABLISHING.” 


depending upon which system sees the other's establishment first. 


The first function of an RJE session is the successful completion of 


security tests. The user must enter a "USERCODE™ and “PASSWORD” 
that the central computer recognizes. Until such time as this is 
accomolished and a "LOGGED ON" control message sent to the remote 
Sit>» ah additional darkened field is printed following every 
console printer message disolayed. This fietd is used for entering 
one’s "USERCODE™ and “PASSWGRD® thereby providing remote system 
security. An example of the Logon orocedure is; | | 


weee BI7T00 QJE TVel O7715/74//102092307 xaee 
ONLINE 

5 6700 SYSTEM/RJE 2.5260 MIX = 6415. 
dadaddadaga 

¢# USERCIDE? 


6"? 
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3949929932 
@ AND YOUR PASSWORD?: 
aaaaaaaaaa 


RJE LOGGED ON AT 10209231 O1/21/74.. 
SESSION 6417. 


The darkened fields (333) are used for entering one's *"USERCODE* and 
"PASSWORD”™. Refer to the central computer's RJE manual for each 
System's unique tog-on requirements. 


REMOTE DECKS 


Alt cards with tnvalid characters in the first column are considered 
to be control cards for the B1700 MCP. Since decks to be sent to 
the central computer system also have invalid characters in the 
first column of control cards €Csee 86700 or B2700/3700/4700 system 
information manual for the exact deck format)» a special feature 
has been implemented in B1700 MCP II permitting programs to read 
control cards» namety the STREAM and TERMINATE super delimiters. 
Ali remote decks must have the following format: | 


?STREAM RJE/CARDS 
REMOTE DECK(s) 
‘TERMINATE RJE/CARDS 


All card images in the remote deck(s) with invalid characters in 
column one wilt be passed to the central computer after RJE/MCS has 
converted the tnvalid character to a null (3003) character. MCP II 
rejects cards with an invalid character in any column other than 
column onee 


ALL decks» regardless of size» must have the delimiters around them. 
If the last card 15 not a terminate cards RJE/MCS will hang waiting 
for another card. STREAM and TERMINATE super delimiters may also 5e 
used with pseudo card readerss there is no difference in the format 
of the remote deck(s). Onty EBCDIC card decks may be read. 


if the RJE user desires to file equate the card file. to tape or 
11sk» that file must be built with the required centrat computer 
control cardse It 1s an RJE requirement that all data cards and 
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control cards for a particular job must be contiguous. When card 


images are in a tape file or disk file there is no such thing as an 
invalid character. Therefore it is necessary for the RJE user when 
creating disk er tape files for transmission by RJE to make sure 


that column one on att central computer control cards contains a 


null code (9904). 


Tne RJE user can create tape or disk files for RJE transmission by 
using the STREAM and TERMINATE super delimiters. [f a card file is. 
delimited by STREAM and TERMINATE» the MCP will return an exception’ 
condition if column one is an invalid character on 80 column 
equipment or a question mark on 96 column equipment. The card 
reader exception procedure must check for a question mark in column 
one and reolace it with a null before writing the card itmajzje_ to 
tape or disk. 


When using 96 column readers» question marks (7) in column one are 
treated the same as invalid characters by the 81700. The RJE user 
must avoid having data cards with question marks in column one. 


The 317090 converts invalid characters in cotumn one of 80 column 
readers to question marks. ” 


CENTRAL COMPUTER SYSTEM CONTROL MESSAGES 


Normal console printer input messages for transmission to the 
central computer use the following form Cup to 72 characters): 

<MIX INDEX>AX<MESSAGE> 
where <MIX INDEX> refers to the mix number of the RJE/MCS program. 


The content and format of these console printer messages is 
dependent on the central computer system. In generat» these 


messages include all central computer system input messages which 


allow the remote user to check the status of» and exert control 
overs all programs and data files entered via the remote terminal. 


: 
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| LOCAL CONTROL MESSAGES 

if a console printer message is entered with a "." (period) as its 
first character» it is considered to be a local control message 
dintended for the RJE/TERMINAL packages These are of the form: 

| 

<MIX INDEX>AX. OPERATOR 

Note: The first character after AX must be a ".". 

. If the operator does not conform to any of the six possible 
commands» the message: 

"ERROR: INVALID OPERATOR IN "2" INSTRUCTIONs RE-ENTER.” 

is displayed. 

e ~CLoP 

The close card punchs .CLCPs» command wilt close the card punch file. 


(Ze RSE SERRA E SEALE SSASLE RES ERASE SRE RAR ALARA SESE Se ee ee 


* * 
« | Smix-index>AXeCLCP 


sy * 
RRR KEKE REE RAH HEAKEKKEEKHEKHEEKEKKEKKEERKKKKKEKEREK 


etliP 


The close line orinters .CLLP» command will close the printer file. 
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The card punch not readye eCP NR» command informs the 81700 RJE/MCS 
orogram and the central comouter system that the card punch = has 
become not ready. The centrat computer system witt temporarily 
suspend transmitting buffers for the punch device. 


It is the responsibility of the 81700 RJE operator to inform the 
B1700 RJE/MCS program and the central computers that the card punch 
is ready to receive datas The tocal control command cready card 
punch» PY CP» has been provided for this purpose. If the card 
punch device has become inonperatives then the Local control command 
Save card punchs .SV CPs has been provided. 
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* . ¥ 
® <mix-index>AXeCP NR fe 
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The establishments» »£ST» command causes the 81700 RJE/NDLDCH program 
to attempt to reestablish the tine connection with the central 


computer system. The message “ONLINE™ is displayed when the line 


connection is reestablished. 


The «EST command may be used in conjunction with the retry function. 
The error message "RETRIES“UP*" is displayed when the current buffer 
detng sent to the central computer system is not being received. By 
entering the «EST command the buffer being sent will be discarded 
and an attempt will be made to rewestablish the tine connection. 
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LP NR 


The tine printer not ready» .LP NR» command informs the 81700 
RJE/MCS program and the central computer system that the line 


printer has become not ready. The central comouter system will 


temporarily suspend transmitting buffers for the printer. 


It is the responsibility of the 81700 RJE operator to inform the 
81709 RJE/MCS program and the centrat computer» that the line 
printer is ready to receive data. The tocal control command = ready 


tine printers .~RY LP» has been provided for this purpose. If the 


line printer has become inoperatives then the local controt command 
Save Line printers .SV LP» has been provided. 
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The queue Sizes .~QS=NNNN» command atlows the user to set the maximum 


number of puffers than can be queued hetween the RJE/MCS and the 


network controller (See section on queue depth control). "NNNN® is 
one to four decimal digits that the new queue depth limit wilt be 
set to. A value of 0 for "NNNN™ will set the queue depth to 
infinity. | 


SCE RSSERESSO SALES ESSE SEC SSS SSCS SSCCLCAS CSCS LL Ss ae tS 


& | | « | : 
i | _ <mMixminde x>AXeQS=NNNN te 
a m 


Ce EEE REE REE ERERREREREREEEAKKEAE KEK AEHRE KKK 


: 
; 
| 
5 
i 
a 
| 
i 
¥ 
‘ 
i 
: 
: 
i 
J 
ct 
Ht 
st 
i 
s 
ii 
“4 
i 
: 
i 
“ 
| 
‘ 
4 
a 
i 
i 
it 
a 
i 
al 
A 


67 


BURROUGHS CORPORATION | — COMPANY CONFIDENTIAL 


COMPUTE? SYSTEMS GROUP R1700 RJE/STERMINAL CNOL) 


SANTA BARBARA PLANT | Pe. Se 2212 5249 


@READ or 2 RE 
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The read» «READ or «RE» command causes the B1700 RJE/MCS program to 
open acard file labetted "RJE/CARDS™ and begin transmitting the 
data to the central computer system. When the end of file condition 
has been detecteds the card file will be closed. The «READ or «RE 
command is required to read each card file. A card file is any 
group of cards whose first card is a STREAM card and whose tast 
card is a TERMINATE card. | | 


The «READ or «RE command is only valid if the B1700 RJE/NDLOCH and 
RJE/MCS crograms have been properly togged on with the central 
computer. tt is possible to override this feature by entering the 
Local command «RY CR. 
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The réady card punches RY CP» command informs the 81700 RJE/MCS 
projram and the central computer system that the card punch device 
is mow ready to receive datae Any data stream that was temporarily 
susnended by using the .CP NR Local control command will continue 
without toss of data» if the Local control command «SV CP was 
antereds the data file will be transmitted beginning from the first 
record of that file. : - 
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The «RY CP command is onty valid if the «CP NR or .SV CP was issued 


oreviously. 
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The ready card readers eRY CRe command will enable the 81700 RJE/MCS 
program to read cards agains if the central computer has instructed 
the 81700 RJE/MCS orogram to halt temporarily or abort its card 
reader. The eREAD or .RE tocat command is stilt required before the 
B17099 RJE/MCS program can start reading cards. 


If the 81700 RJE/MCS program has not been properly logged on with 
the central comouter» the -RY CR command witl allow the 81700 
RJE/MCS oprogram to read cards and transmit the data file. In 
addition» the darkened field that is displayed after every console 
printer message sent from the central computer will be ignored. 
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The ready Line printers «RY LP» command informs the 81700 RJE/MCS 
orojram and the central computer system that the line printer is 
now ready to receive data. Any data stream that was temporarily 
susoended dy using the «LP NR Locai control command will continue 
without loss of data. If the tocal controt command .SV LP was 
entered» the data fite witt be transmitted LL from the first 
record of that file. 
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The «RY LP command is only valid if the «LP NR or «SV LP was issued 
, orevioustly. | | | 

| eSIZE=NNN 

: The size» .SIZE=NNN» command atlows the B1700 operator to set the 
| maximum buffer size being transmitted to» and received from the 


central computers» where “NNN” is a three position decimal number 
from 080 te 402. 3 
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2ST3P or .ST. 


The stone «STOP or «ST» command notifies the central computer system 
that the 81700 system is terminating the RJE session. The 81700 
RJE/NOLOCH programs breaks the Data Comm tine connection and 
terminates the 81700 RJE/MCS program. c 
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Th ah mh a i ae 


The save card punches «SV CP» command informs the central computer 
that the-entire card punch data stream being transmitted is to be 
Saved at the central computer site. The .SV CP command will 
permanentty inhibit the transmission of any further ounch 9 streams 


from the central computer. To rerestablish the punch stream» enter 


the tocal control commands «RY CP. This will inform the central 
computer to start sending any punch streams that are available for 
transnission. Att punch streams will start from the beginning of 
the file. 
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.SV LP 


am ah hh om ah 


The save Line printers «SV LP.» command informs the central computer 
that the entire print stream being transmitted is to be saved at 
the central computer site. The .«SV LP command witl permanently 
inhibit the transmission of any further print streams from the 
central computer. To rewestablish the print streams enter the ltocal 
control command «RY LP. This will inform the central computer to 
start sending any -print streams that are available for 
transmission. Atl orint streams will start at the beginning of the 
file. | 
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: oWATT or WI 

The awaits eWAIT or .WT» command will inform the central computer 
that the 81700 RJE/NDLOCH is going to break the Data Comm Line 
: connaction - and wait for a catl from the central computer system. 
The B1700 RJE/NDLOCH program wilt issue a test-op for 
datawsetrreadye when data™setrwready comes true» the R1700 
RJE/NOLICH wilt resestablish communication with the central 
computer. 

The .WAIT of .WT can only be used when the Data Comm Line connection 
| betaeen the central comouter and the 31700 system is switched. 
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RJF/MCS OUTPUT MESSAGES 
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RJE/MCS may display a number of messages either in response to 4a 
local control message being entered» in response to a message heing 
received from the centrat computer or when the program itself 
$2enses 4a condition of which the operator should be notified. 


1. "ERRGR: INVALID OPERATOR IN “2” INSTRUCTION» REWENTER.™. 


The control command just entered was found to be invalid. The. 
operator should enter the correct command. 
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24 "ERROR NO "=" IN "QS" INSTRUCTION.™. 


on 
6 


This message occurs when a *%.QS" command message 1s entered 


which lacks an equal sign. The correct format is “".QS=NNNN". 
The ".65" request will be ignored. The operator should re-enter 
the command correctly. 


"ERROR? OPERATOR INVALID» DEFAULT VALUE USED.". 


This error occurs when a non-numeric field is entered in a 
"eSTZE=NNN™ control message. The default puffer size of 492 
will be used. If this value differs from the current values a 
message will be sent to the centrat computer requesting a 
change be made to the buffer size. 


"ERROV2 OPERAND OUT OF RANGE» CURRENT VALUE USED... 


This 1s displayed when a *.SIZE=NNN”™ control message is entered 
and the three digit decimal in the instruction is not between 
39 andi 402 inclusive. The current buffer size is assumed and no 
buffer size change is sent to the central computer. 


"ERROR: "2.05" CPERAND INVALID... 


If a non-numeric field is entered in a “.9S5" control message» 
then this message is displayed. fhe control message will be 
ignored and it wilt be necessary to reenter the message 
correctly. 


"ERROR? "QS" OPERAND TOO LONG.". 


4ore than four numeric character were entered in a %™.QS"” 
instruction. It will be necessary to re-enter the message 
correctly to change the change the queue depth. 


"40ST SYSTEM CARD READER ABORT.”. 


ahen a message is received from the central computer system 
abortina the remote card readers this message is displayed. If 
a card file is actives the file is closed and flushed. It will 
not be possible to enter any other cards to the program until 
eitner a message from the central computer is received 
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1). 


Li. 


LS. 


indicating that it will once again cee cards or a “™.eRY CR*™ 
control message is entered. 


"HOST SYSTEM CARD READER HALTED.". 


This indicates that a request has been received from the central 
computer to temporarily suspend the remote card reader. The 
remote card file will stilt be retained but no further card 
buffers wilt be transmitted until a card reader ready message 
is received from the central computer or a “.RY CR™ message 15 
entered on the remote console orinter. 


"HOST SYSTEM CARD READER READY... 

After either a "CARO READER ABORT” or "CARD READER HALT" message 
is sent by the central computers when the central computer 15s 
able to receive data once again this message will be displayed. 
Cards will then by read dy RJE/MCS. 

"INPUT FILE EOF.™. 

After processing an input file» the program will display this 
message when end of file has been read on the input file and 
the file is closed. A special end of file control message will 
also be sent to the central computer at this time. 

"LOS FEATURE NOT IMPLEMENTED IN NOL/RJE.”™. 

The NOL generated handler has no provision for counting Line 
activity. 

"PARITY ERROR ON CARD PLEASE READ LAST CARD AGAIN." 

When processing an input file» should a parity error occur this 
message witl be pereerayees The operator should resubmit the 
last card read. . 4 


"PRINTER EQF.™. 


After an entire print file has been transmitted to the remotes 


the central computer transmits a special "EOF" control message. 
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The. RJEJMCS will close the printer file and display this 
message when the control message is received. : 


PUNCH EF a 


After an entire punch file has been transmitted to the remote» 
the central computer will transmit a special "EGF" control 
messagee The RJE/MCS program wilt close the punch file ang 
display this message when the message is received. 


"PRINT»PUNCH. QUEUE OVERFLOW: PROGRAM ABORT.” 


The RJE/MCS program maintains a disk file queue to store buffers 
received for the printer or punch after the device has become 
not ready and a “.LP NR™ or ".CP N&R” control message has been 
entered at the remote console printer to notify the central 
computer of a not ready condition. Should the central computer 
continue to send data to the remote site after receiving the 
not ready messages the disk file would eventually overflow. The 
RJE/“CS program will display this message» give a program dump 
of itself and go to end of job. 


"REQUEST IGNORED? CARD FILE STILL OPEN.". 


If a ".2EAD™ control message 15 entered while the RJE/MCS 
program has an input file actives» this message will be 


displayed and the ".READ™ message discarded. 


"REQUEST IGNORED? CARD READER ABORTED.". 


tf a ".READ™ control message is entered while the card reader is 
aborted (the messaje “HOST SYSTEM CARD READER ABORTED™ having 
been disotayed but neither a *.RY CR*™ message entered nor a 
"HOST SYSTEM CARD READER READY.” displayed)» then this message 
is displayed. It wilt not be possible to enter cards until the 


card reader becomes ready. 


REQUEST IGNORED: NOT LOGGED ON.” 


it is not possible to enter cards to the RJE/MCS program until 
a lojced on control message has been received. If this is 
attemoted>» this message will be displayed in response to the 
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",READ” control message. It is possible to override this 
feature by entering a “eRY CR™ control message if the RJE/MCS 
orogram is not logged on. | 


19. “WARNING? STILL LOGGED ON.". 


If RJE/MCS detects an ENF on its remote files» indicating a “QC” 
system control message was entered to send the network 
controller to end of jobs» the RJE/MCS will display this message 
before going to end of job» if the B1700 was still togged on 
with the central computer. | | 


RJE/NDLDOCH QUTPUT MESSAGES 
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RJE/NDLOCH wilt display messages for certain error conditions which 
may be serious enough to require action by the operators it wilt 
attempt to recover on its own if possible. The format of the error 
messages appears below. | 


Le “ESTABLISHMENT RETRICS UP.”. 


When trying to establish a connection with the centrat conputer » 
after fifty transmissions of an "ENQ"s if a valid reply is not 
receiveds this message is displayed. RJE/NOLOCH will then send 
a "OLE*FOT™ and disconnect if switch lines are being used. I[f 
leased tines are being used» RJE/NOLDCH will send an "EQT™ and 
return to trying to establish a connection. 


2e "HOST ESTABLISHING.”™. 


The receiopt of an “ENQ* character from the central computer will 
cause this message to be displayed. It is an indication that 
the centrat computer system is rewestablishing the connection 
between itself and the remote computer. RJE/NDLDCH acknowledges 
the message and continues. 


3. "HOST TERMINATING." 


The receipt of an “FQT" when running on teased tines or a 
"OLE*5OT" wher running on switched lines wilt cause this 
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message to be displayed. It is an indication that the central 
computer system is going down. RJE/NDLOCH will disconnect if 
running ona switch Line or witl attempt to reestablish i5 
running on Leased lines. 


"LOSS OF DATA SET READY.". 


Juring the tast I/9 sequences the data set went down. When this 
occurs»s if switched tines are being used» RJE/NDLDCH will 
disconnect Cif a connection had been established). The user 
must then rewdial the central computer system. 


"ONLINE. 


when attempting to establish communications with the central 
computers either at the start of an RJE session or after the 
Local command “".EST" was entered. This message will be 
displayed when a valid acknowledgenent to the establishment 
request is sent by the central computer system. 


"RETRIES UP.™. 


This indicates that the current buffer being sent to the central 
computer is not being acknowledged» either due to the central. 
computer NAKing the message or because of tine problems which 
cause exceptions whenever the message is transmitted. After the 
retry Limit has been reacheds the “RETRIES UP.” message. is 
disolayed by RJE/NDOLDCH. RJE/NDLDCH then requeues the current 
ouffer. If a buffer is queued for another station then it 
attempts to transmit it» otherwises RJE/NOLOCH continues trying 
to transmit the same buffer. Should an “.EST™ message be 
received at this times then the message being retransmitted 
will oe discarded before the link is re-established. | 


| | 6°17 
3URROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP Bi700 RJE/STERMINAL C(NDL? 
SANTA BARBARA PLANT | Pe Se 2212 5249 


ASYNCHRONGUS DATA COMM WITH RJE 
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Tne NOL version of 81790 RJE/TERMINAL software allows the user to 
define other terminals» stations» tines and files itn RJE/NOLDCH 
(the network controller). A user written program can then read and 
write to these additional stations asynchronously with the 
execution of RJE. The following is a tist of restrictions that the 
user must adhere to in order to effect asynchronous data comm with 
R JE. 


1. Any new stations added to RJE/NDLOCH. must fol low ene. fourth RJE 
Station (Station 54). 


2e RIE/SMCS will unconditionally approve all remote file opens with 
the MCS non-participating as tong as there are stations 
involved and the stations involved are not any RJE stations. 
Since RJE/MCS approves the "REMOTE FILE OPEN"»s it is necessary 
that RJE/MCS be executing when the user program . starts 
executing or the user program wittl be suspended by the 
condition "NO MCS OR NETWORK CONTROLLER PRESENT.” 


Se  RIESMCS unconditionatly approves any non-dummy station 


attached» as long as the attached station does not involve any 
RJE stations. 


4. whenever RJE/MCS causes the execution of RJE/NDLDCH all 
controls and requests witt be started» whether the user program 
iS oresent or note When. no user program 35 presents any 
messages received from non=RJE stations will be discarded. 
Howevere non-RJE messages received when the user program is 
present will be transferred to the user program by the network 
controller. | 
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FILES 


RJE/MCS FILES | 


Lt. CARD FILE 
INTERNAL NAME = RJECARDS 
LABEL = RJE/CARDS 
DEVICE = CARD 
OPEN. OPTION = INPUT 
RECORIS = BO/1 


» PRINTER FILE 


? 

: INTERNAL NAME = RJEPRINT 

LABEL = RJE/PRINT | 

DEVICE = PRINTER OR BACKUP DISK 
-_ | OPEN. OPTION = OUTPUT» LOCK 
RECORDS = 132/1 | 

Se PUNCH FILE 


INTERNAL NAME = RJEPUNCH 
LABEL = RJE/SPUNCH 

DEVICE = PUNCH OR BACKUP DISK 
SPEN.SOPTION = OUTPUT» LOCK 
RECORNS = 80/1 . 


4. MCS QUEUE FILE 
INTERNAL NAME = MCSQUEUE 
LABEL = MCSQUEUF. 
DEVICE = REMOTE WITH HEADERS 
JPEN. IPTION = INPUT/OUTPUT 
ZECTRIS = 4595/1. 


_ de) «©6PRINT PUNCH QUEUE © 

7 INTERNAL NAME = PRINT.PUNCH. QUEUE 
LABEL = "RJE.MCS*"/"QUEUE” 

DEVICE = DISK» RANDOM © 
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RECORDS = 455/1 
AREAS = 1730 
OPENED = INPUT» OUTPUT» NEW 
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LOCKOUT 
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